home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / pcboard / wild12.zip / WILD.DOC < prev    next >
Text File  |  1996-05-01  |  22KB  |  538 lines
  1. WILD.PPE -  By Dan Shore - SysOp
  2.                The Shoreline BBS
  3.                (301) 946-2771
  4.                 May 1, 1996
  5.  
  6.  Purpose -  Give the user an opportunity to select which files to flag
  7.             during a wildcard download instead of all the files being
  8.             flagged first by PCB, then having to edit the files right
  9.             before downloading.
  10.  
  11.             When issuing the download command which contains wildcard
  12.             requests, the user will be prompted with a list of
  13.             filenames.  At this point they flag the files they wish to
  14.             download by number (ranges also accepted).  These flagged
  15.             files are then passed back to PCB to process (ratio's,
  16.             time, etc.) once they exit the PPE.
  17.  
  18.  
  19.    *******************************************************************
  20.      WARNING  ---   WARNING  ---  WARNING  ---  WARNING  ---  WARNING
  21.  
  22.      For this PPE to function correctly you MUST be running PCB 15.21
  23.    *******************************************************************
  24.  
  25.  
  26.    YOU MAY NOT ENGAGE IN NOR PERMIT THIRD PARTIES TO ENGAGE IN ANY
  27.    OF THE FOLLOWING:
  28.  
  29.    1. ATTEMPT TO DISASSEMBLE, DE-COMPILE, OR REVERSE ENGINEER THE
  30.       SOFTWARE OR THE FILES IT GENERATES IN ANY WAY.
  31.  
  32.    2. MAKING ANY KIND OF ALTERATION TO THE SOFTWARE OR THE FILES THAT
  33.       ARE CONTAINED WITHIN THE MAINMAIL ARCHIVE FILE.
  34.  
  35.    3. GRANTING SUB-LICENSES, LEASE OR OTHER RIGHTS IN THE SOFTWARE TO
  36.       OTHERS.
  37.  
  38.  
  39.    WARRANTY AND DISCLAIMER:
  40.    ────────────────────────
  41.  
  42.    THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  43.    INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  44.    PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  45.    PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  46.    GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  47.    RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN
  48.    WITHOUT ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR
  49.    OWN RISK. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM
  50.    DAMAGE, LOSS OF PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR
  51.    CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OR INABILITY TO USE THIS
  52.    PRODUCT.
  53.  
  54.    WILD.PPE is copyrighted (c)1995 by Daniel A. Shore. ALL RIGHTS RESERVED.
  55.  
  56. ---------------------------------------------------------------------------
  57.  
  58. A. INSTALLATION
  59.    ────────────
  60.  
  61.    1.  Add two new entries to your CMD.LST file(s)
  62.  
  63.        Your entries in CMD.LST should look something like the following:
  64.  
  65.                             Charges Per     PPE/MNU File Specification -or-
  66.            Command    Sec  Minute    Use    Keystroke Substitution
  67.        ══════════════ ═══ ═════════════════ ═════════════════════════════════
  68.        D                5        0        0 C:\PCB\PPE\WILD\WILD.PPE
  69.        DB               5        0        0 C:\PCB\PPE\WILD\WILD.PPE
  70.  
  71.           (Change the security level and path to match your system)
  72.  
  73.  
  74.    2. Change PCBText entries 61 & 728 to the following:
  75.  
  76.          !c:\pcb\ppe\wild\wild.ppe DL
  77.  
  78.        Or you can change your PCBText by using:
  79.  
  80.        MKPCBTXT C:\PCB\GEN\PCBTEXT /I:61 "!c:\pcb\ppe\wild\wild.ppe DL"
  81.        MKPCBTXT C:\PCB\GEN\PCBTEXT /I:728 "!c:\pcb\ppe\wild\wild.ppe DL"
  82.  
  83.        (Change the paths to match your system)
  84.  
  85.  
  86.       Change PCBText entries 223 & 585 to the following:
  87.  
  88.          !c:\pcb\ppe\wild\wild.ppe FL
  89.  
  90.        Or you can change your PCBText by using:
  91.  
  92.        MKPCBTXT C:\PCB\GEN\PCBTEXT /I:223 "!c:\pcb\ppe\wild\wild.ppe FL"
  93.        MKPCBTXT C:\PCB\GEN\PCBTEXT /I:585 "!c:\pcb\ppe\wild\wild.ppe FL"
  94.  
  95.        (Change the paths to match your system)
  96.  
  97.  
  98.    3. Edit the WILD.CFG which contains a MINIMUM of 2 entries.
  99.  
  100.           Example of WILD.CFG:
  101.           ───────────────────
  102.           51
  103.           110
  104.  
  105.  
  106.       A.  The first entry is for the maximum number of files that will
  107.           be matched per wildcard request (a wildcard request is a
  108.           filename that contains a DOS wildcard).  A setting of 51 makes
  109.           for a nice full screen display to the user.  The SysOp is able
  110.           to change this value to whatever you wish.  REMEMBER the
  111.           higher the number the longer a search will take.  Do not enter
  112.           a number that is higher than 99.  If the user cannot find
  113.           their file in 99 files then their search criteria is too
  114.           large.
  115.  
  116.       B.  The second entry is the security level that allows a "*.*"
  117.           WildCard download.  If the users security level is GREATER
  118.           THAN OR EQUAL TO this level, then they are allowed to perform
  119.           a "*.*" download.  If their security level is lower than this
  120.           value and they attempt a "*.*" download, the file "ALLSEC"
  121.           (which is located in the same directory as WILD.PPE) will be
  122.           displayed to the user.  The SysOp can customize this file in
  123.           any way they wish.
  124.  
  125.  
  126.       (Remember the batch download limit in PCB is 99 files max.)
  127.  
  128.       NOTE:  WILD.CFG must reside in the same directory as WILD.PPE
  129.  
  130.  
  131.    4. The file WHLP is a help file, and must reside in the same
  132.       directory as WILD.PPE
  133.  
  134.       (Language specific help files are supported)
  135.  
  136.  
  137.    5. All text displayed by WILD.PPE is contained in an external file
  138.       called "WILDTXT".  This file MUST be in the same directory as
  139.       WILD.PPE
  140.  
  141.       (Language specific WILDTXT and language specific YES/NO replies are
  142.        supported)
  143.  
  144.  
  145.     WILD.PPE and Filename Stacking
  146.     ──────────────────────────────
  147.  
  148.     WILD.PPE will accept stacking of filenames for processing.  Below
  149.     are examples of what the user can do:
  150.  
  151.     At the Main Menu prompt:
  152.     ───────────────────────
  153.     (47 min. left) Main Board Command? D Z*.* WINZIP60.ZIP WIN*.*
  154.  
  155.  
  156.     At the "Enter filename to download prompt":
  157.     ──────────────────────────────────────────
  158.     Enter the filename to Download (Enter)=none? Z*.* WINZIP60.ZIP WIN*.*
  159.  
  160.  
  161.     WILD.PPE will process the WILDCARD requests FIRST and then will pass
  162.     the NON-wildcard filenames to PCB for processing once ALL the
  163.     wildcard requests have been processed.  As you may have noticed,
  164.     normal filenames along with wildcard requests are accepted on the
  165.     command line.
  166.  
  167. =============================================================================
  168.  
  169. B.  WHAT WILL THE USER SEE WHEN DOWNLOADING USING WILDCARDS:
  170.     ───────────────────────────────────────────────────────
  171.  
  172.     Below is an example of a wildcard download session using WILD.PPE
  173.  
  174.     (We have commented each section to let you know what is occuring)
  175.  
  176. =============================================================================
  177. *1.  User starts a download by stacking their request at the main board
  178.      command prompt.  (The PPE will allow multiple filenames stacked here
  179.      or the user can enter "D", then RETURN, and enter in their request(s)
  180.      at the "Enter the filename to Download (Enter)=none" prompt.)
  181. =============================================================================
  182.  
  183.  
  184. (47 min. left) Main Board Command? d cdsk*.*
  185.  
  186.  
  187. =============================================================================
  188. *2.  The PPE is now invoked, due to it finding a wildcard request on the
  189.      command line (CDSK*.*).  While the search is in progress, the user
  190.      can interrupt it at any time by hitting the ENTER key (this is a
  191.      safeguard built in in case of a long or incorrect search entered by
  192.      a user that needs to be interrupted). Once the search is completed,
  193.      the user is informed how many filenames matched their wildcard
  194.      request. A list of filenames is then presented to the user,
  195.      followed by the wildcard command prompt.
  196. =============================================================================
  197.  
  198.  
  199. Hit [ENTER] to interrupt search...
  200. Wildcard search in progress for : CDSK*.*
  201. Total Filenames matching your Wildcard Request = 3
  202.  
  203. Files matching your request
  204. ───────────────────────────
  205.  
  206.  1.   CDSKA821.ZIP       2.   CDSKB821.ZIP       3.   CDSKC821.ZIP
  207.  
  208.  
  209. WildCmd: E)dit,H)elp,F)lag,L)ist,R)elist,(Enter)=quit? (F)
  210.  
  211. =============================================================================
  212. *3.  The user can flag files by entering the NUMBER(s) of the file(s),
  213.      instead of typing the filenames. They can enter single numbers,
  214.      multiple numbers seperated by spaces or semi-colons, or a range of
  215.      numbers using a hyphen.  In our example the user has choosen to
  216.      "F"lag files, and has decided to flag a range of files "1-3".  The
  217.      user is then informed of how many files have been flagged by their
  218.      request.  (If a file number is out of range, they will be properly
  219.      informed.)  WILD.PPE will not allow a user to FLAG more files than
  220.      allowed by the password file setting for batch download limits.
  221.      The program will alsonot allow the same file to be flagged twice.
  222. =============================================================================
  223.  
  224. Enter File NUMBER(s) to Flag,
  225. Ex: 1 2 5-9 14 etc. ([ENTER] Quits)? 1-3
  226.  
  227.      3 Wildcard files have been flagged
  228.  
  229. WildCmd: E)dit,H)elp,F)lag,L)ist,R)elist,(Enter)=quit? (E)
  230.  
  231. =============================================================================
  232. *4.  The user can edit (remove) files they have flagged by choosing the
  233.      "E"dit command.  They will first be presented with a prompt asking
  234.      them if they wish to remove All Flagged Files.  If they enter NO
  235.      then each filename they flagged will be displayed to them at which
  236.      time they have the option of keeping the file or not:
  237. =============================================================================
  238.  
  239. **NOTE** You can remove ALL files at once or be prompted for each file
  240. Do you wish to remove All Flagged Files (Y,[N]) (Enter=no)
  241.  
  242. Keep CDSKA821.ZIP in flagged file list? (Y,[N])? y
  243. Keep CDSKB821.ZIP in flagged file list? (Y,[N])? y
  244. Keep CDSKC821.ZIP in flagged file list? (Y,[N])? y
  245.  
  246. WildCmd: E)dit,H)elp,F)lag,L)ist,R)elist,(Enter)=quit? (L)
  247.  
  248. =============================================================================
  249. *5.  The user can list files they have flagged, as a way to verify or
  250.      check what files are currently flagged (these are files only
  251.      flagged for THIS current wildcard request). In this example the
  252.      user choose to "L"ist flagged files, and they are presented with
  253.      the following:
  254. =============================================================================
  255.  
  256.         List of Flagged Wildcard Files for Downloading
  257.  
  258.  1.    CDSKA821.ZIP      2.    CDSKB821.ZIP      3.    CDSKC821.ZIP
  259.  
  260.  
  261. WildCmd: E)dit,H)elp,F)lag,L)ist,R)elist,(Enter)=quit? (H)
  262.  
  263. =============================================================================
  264. *6.  At the Wildcard command prompt, the user can get help for the
  265.      available Wildcard commands (the file WHLP is displayed).  In this
  266.      example, the user choose "H"elp and they are presented with the
  267.      following:
  268. =============================================================================
  269.  
  270.               Wildcard Command Help
  271.  
  272.     [E]dit ..... Edit list of files that were flagged
  273.                    in this Wildcard session
  274.     [H]elp ..... Show this menu
  275.     [F]lag ..... Flag file(s) from the displayed list
  276.                    of filenames
  277.     [L]ist ..... Show Wildcard files that are currently
  278.                    flagged in this session
  279.     [Q]uit ..... Exit Wildcard (hit ENTER)
  280.     [R]elist ... Display the list of files again
  281.  
  282. WildCmd: E)dit,H)elp,F)lag,L)ist,R)elist,(Enter)=quit? (R)
  283.  
  284. =============================================================================
  285. *7.  With all the selections available to a user, the original list of
  286.      filenames can scroll off the screen.  By choosing the "R"elist
  287.      command, the user can once again see the list of matching filenames
  288.      for their wildcards request without having to perform another
  289.      search.
  290. =============================================================================
  291.  
  292. Files matching your request
  293. ───────────────────────────
  294.  
  295.  1.   CDSKA821.ZIP       2.   CDSKB821.ZIP       3.   CDSKC821.ZIP
  296.  
  297.  
  298. WildCmd: E)dit,H)elp,F)lag,L)ist,R)elist,(Enter)=quit? ( )
  299.  
  300. =============================================================================
  301. *8.  When the user is finished flagging, viewing, editing, or relisting
  302.      files, all they have to do is hit ENTER to exit WILD.PPE
  303.  
  304.      If they flagged files while in the PPE these files will be flagged
  305.      and processed by PCB for downloading. In this example the user
  306.      flagged three wildcard files, and exited the PPE, and the following
  307.      was presented to them:
  308. =============================================================================
  309.  
  310. Checking file transfer request.  Please wait, Dan ...
  311. (1)   CDSKA821.ZIP  413533 bytes,  5.2 minutes (approximate)
  312. (2)   CDSKB821.ZIP  198945 bytes,  2.6 minutes (approximate)
  313. (3)   CDSKC821.ZIP  392147 bytes,  5 minutes (approximate)
  314.  
  315. Download Flagged Files? (Y)
  316.  
  317. (4) Enter the filename to Download (Enter)=none?
  318.  
  319.  
  320. C.  IMPORTANT POINTS ABOUT WILD.PPE
  321.     ───────────────────────────────
  322.  
  323.    ***  ANY FILE THAT IS LOCATED IN A DIRECTORY OR AN INDEX IN YOUR    ***
  324.    ***  DLPATH.LST CAN BE MATCHED FOR DOWNLOAD BY WILD.PPE.  WHILE     ***
  325.    ***  THIS MAKES WILD.PPE A VERY POWERFUL PPE, IT CAN ALSO CAUSE     ***
  326.    ***  SOME SECURITY PROBLEMS.  READ ITEMS #2 AND #3 IN THIS SECTION  ***
  327.    ***  ON HOW TO STOP WILD.PPE FROM MATCHING SPECIFIC FILENAMES OR    ***
  328.    ***  FROM MATCHING ANY FILES IN DEFINED DIRECTORIES.                ***
  329.  
  330.     1.  As you may have noticed, we let PCB take care of the actual
  331.         flagging of the files so it can check ratios, time remaining and
  332.         anything else that restricts the user during downloading.  Since
  333.         PCB already performs this action, it was not worth "recreating
  334.         the wheel" as they say, within the PPE.
  335.  
  336.     2.  When WILD.PPE is searching for files, it will not put a filename
  337.         in the listing for users to flag if the file is restricted by
  338.         the FSEC file.  For example, lets say you have the following in
  339.         your FSEC:
  340.  
  341.              Directory:  E:\SPFILES\*.*
  342.         Security Level:  10
  343.  
  344.         If the users security level is less than 10, any file that matches
  345.         their request in E:\SPFILES will not be shown to the user as a file
  346.         that can be flagged.  If their security level allows them access to
  347.         this directory, and there is a password associated with these files,
  348.         once the user exits the PPE, PCB will ask for the password. Again,
  349.         we let PCB take care of "most" of the security and restriction
  350.         features of downloading.
  351.  
  352.         One restriction that we do check is WILD.PPE will not allow a user
  353.         to flag more files than is allowed by the batch download limit set
  354.         in the passwords file (PCBSetup).
  355.  
  356.  
  357.     3.  Within WILD.PPE there are two other OPTIONAL ways to *BLOCK*
  358.         files or directories from being matched by WILD.PPE.
  359.  
  360.         THE FIRST WAY TO BLOCK FILES OR DIRECTORIES
  361.         ───────────────────────────────────────────
  362.  
  363.         The first way is to add UP TO 20 extra lines to the WILD.CFG
  364.         file with a maximum of 10 lines containing filenames, and 10
  365.         lines containing directories.
  366.  
  367.         Currently your WILD.CFG which has two entries might look
  368.         something like this:
  369.  
  370.         51     <---- Maximum number of files to match
  371.         110    <---- Security level to allow *.* searches
  372.  
  373.         Now let's say you wanted to block some filenames and some
  374.         directories from being matched.  Here is what your WILD.CFG
  375.         might look like:
  376.  
  377.         51
  378.         110
  379.         DAN.ZIP WIND110.ZIP JOHNSON.ZIP
  380.         C:\PCB\JUNK\ D:\EXTRA\ E:\PARTS\
  381.         ELEC321.ZIP STUFF.ZIP HANGKUS.ZIP
  382.  
  383.         NOTE: ■ Each extra line cannot exceed 256 characters in length
  384.                 or unpredictable results will occur with the PPE.
  385.               ■ Each entry should be seperated by a space of a
  386.                 semi-colon.
  387.               ■ Each dirctory entry must END with a backslash
  388.               ■ You can only have 10 filename lines and 10 directory
  389.                 lines. Any more than 10 will be ignored by the PPE.
  390.  
  391.         No matter which conferences a wildcard download request is made
  392.         in, the WILD.CFG file will be read and the filenames and
  393.         directories will be used to block matches.
  394.  
  395.  
  396.         THE SECOND WAY TO BLOCK FILES OR DIRECTORIES
  397.         ────────────────────────────────────────────
  398.  
  399.         BUT......what if you have more filenames or directories to block
  400.         then can be supported in the WILD.CFG file?  There is another
  401.         option for you, but it will require more work and maintenance.
  402.  
  403.         Under the wildcard PPE directory you would have sub-directories
  404.         which would be a number.  These numbers would correlate to
  405.         conference numbers.  Below is an example of conferences #21 and
  406.         #45:
  407.  
  408.  
  409.         PPE ── WILDCARD
  410.                   │
  411.                   ├───────────────────────┐
  412.                   │                       │
  413.                   │                       │
  414.                   21 (Conference #21)    45  (Conference #45)
  415.                   │                       │
  416.                   └─── FIL21 & DIR21      └─── FIL45 and DIR45
  417.  
  418.  
  419.         Each of the sub-directories (21 & 45) could contain two files
  420.         called:
  421.  
  422.         FILxxxxx - Contains filenames to not match
  423.         DIRxxxxx - Contains paths to not match
  424.  
  425.  
  426.         Format of each file:
  427.         ───────────────────
  428.  
  429.            10 lines maximum with up to 256 characters per line.
  430.  
  431.            FILxxxxx
  432.            ────────
  433.            filename filename filename
  434.  
  435.            DIRxxxxx
  436.            ────────
  437.            c:\junk\ c:\test\ d:\stuff\
  438.  
  439.  
  440.            NOTE:  ■  Use spaces or semi-colons to seperate filenames or
  441.                      directories
  442.  
  443.  
  444.         Now...if you wish to limit files in a particular conference you
  445.         will need to make the subdirectory and create the FILxxxxx with
  446.         the filenames you wish to reject.  If you wish to included
  447.         directories to skip, then you also need to create the DIRxxxx
  448.         in the ### directory.
  449.  
  450.         You will not need to have a sub-directory for every conference
  451.         on your BBS, just the ones you want to have limited from the
  452.         PPE, or the ones you do not have in the .CFG file.
  453.  
  454.  
  455.         NOTE:  ■ YOU CAN ONLY HAVE 10 LINES TOTAL BETWEEN THE .CFG FILE
  456.                  AND THE LINES CONTAINED IN THE SUB-DIRECTORIES!  ANY
  457.                  MORE THAN 10 LINES WILL BE IGNORED.  THE .CFG FILE
  458.                  IS PROCESSED FIRST, WITH THE FILxxxxx AND DIRxxxxx
  459.                  PROCESSED SECOND.
  460.  
  461.  
  462. D.  WILDTXT
  463.     ───────
  464.  
  465.     This file contains all the text displayed by WILD.PPE  (The program
  466.     will support language specific WILDTXT files).  It is recommended not
  467.     to move any of the text in this file around as it will then display
  468.     prompts in the wrong places.  You are welcome to change the colors
  469.     or the wording of any line in this file.
  470.  
  471.     NOTE:  Lines #46 and #47 are used when the program is searching for
  472.            a wildcard match.  #46 is for users that have ANSI support,
  473.            and #47 is for those that do not.  #46 will display a TWIRLY
  474.            to the user, while #47 will display WAIT, one letter at a
  475.            time.  You can change these two lines to anything you wish AS
  476.            LONG AS YOU DO NOT USE MORE THAN FOUR (4) CHARACTERS PER
  477.            LINE.
  478.  
  479.  
  480. E.  Registration
  481.     ────────────
  482.  
  483.     This program is being released under the "Freeware" concept.  If you
  484.     wish the source code, you can purchase it from me (See Section F).
  485.  
  486.  
  487. F.  Source Code
  488.     ───────────
  489.  
  490.     Source code for this PPE is available, but only if your purchase it.
  491.  
  492.     The cost for the source code is $25.00
  493.  
  494.     You can mail me a letter requesting the source code and pay by
  495.     Personal Check, Company Check, or Money Order.  Do not send cash
  496.     through the mail.
  497.  
  498.  
  499. G.  Special Thanks
  500.     ──────────────
  501.  
  502.     A special thanks to :
  503.  
  504.     Tom Hansen of "Church Chatters BBS"        402-593-8863 (ShutDown)
  505.      (Thanks Tom, we all are going to miss your BBS...Hope
  506.       to see you back up and running real soon!!!!)
  507.  
  508.     Buddy Driever of "The PC Addiction BBS"    303-434-7515
  509.  
  510.  
  511.     Thanks guys for your testing, suggestions, and assistance.
  512.  
  513.  
  514. H.  Conclusion
  515.     ──────────
  516.  
  517.     This archive has been zipped with an authenticity verification stamp.
  518.     When you unzip this archive you should see at the end:
  519.  
  520.            Authentic files Verified!   # MMJ131
  521.            THE SHORELINE BBS
  522.  
  523.     If you do not see this, then the file has either been tampered with or
  524.     has been rezipped by an upload processor.
  525.  
  526.     If you have any questions, comments, suggestions, etc. please feel free
  527.     to contact me via NetMail, the PCBoard or the PCBNet conferece in FIDO,
  528.     or the PPL conference on RIME.
  529.  
  530.  
  531.     Dan Shore                  (301) 946-2771  - Node 1 (public access)
  532.     The Shoreline BBS          (301) 946-4202  - Node 2 (subscribers)
  533.     4312 Ferrara Court         (301) 946-8153  - Node 3 (public access)
  534.     Silver Spring, MD 20906    (301) 946-5733  - Node 4 (public access)
  535.                                 Fido Address   - 1:109/458  1:109/457
  536.                                 RIME Address   - #1205 or SHORELINE
  537.                                 E-Mail Address - dan.shore%sline@ghawk.com
  538.